home *** CD-ROM | disk | FTP | other *** search
/ Super PC 27 / Super PC 27 (ClarisWorks y shareware).iso / spc / util / executor / readme.1st < prev   
Encoding:
Text File  |  1995-03-18  |  9.3 KB  |  245 lines

  1. 1.99x DENOTES EXPERIMENTAL VERSIONS OF EXECUTOR
  2.  
  3. In an effort to keep our customers in the development loop, we are
  4. periodically releasing experimental versions of Executor.  These
  5. experimental versions are numbered 1.99a, 1.99b, 1.99c, etc.  We try
  6. not to break features with new releases, but sometimes that happens,
  7. so be aware that anything mentioned in these notes may fail to work.
  8. To keep totally up to date, you should join the Executor Interest
  9. mailing list.  To do so, send e-mail to "majordomo@nacm.com" with a
  10. blank subject line and a mail body of "subscribe executor" and then
  11. you'll have access to a more timely forum concerning the latest
  12. developments in Executor.
  13.  
  14.  
  15.  
  16. HOW TO INSTALL
  17.  
  18. This distribution has an installation program which will automatically
  19. install Executor from two floppies.  To run the installation script, make
  20. sure that the first floppy (the one with this README.1ST file on it) is in
  21. your 3.5" floppy drive.  If that drive is drive "A:", all you need to
  22. do is:
  23.  
  24.         C:\> A:\INSTALL
  25.  
  26. Unlike previous versions of Executor's installer, starting with 1.99i,
  27. the installer program will allow you to install Executor anywhere on
  28. your hard drive.
  29.  
  30.     IMPORTANT:
  31.  
  32.     If you are using disk cacheing you should set it to only do read
  33.     caches.  Write caches can result in the ".hfv" files being
  34.     corrupted if Executor dies unexpectedly.  (NOTE: if you forget to
  35.     turn off your write cache, you may have to reinstall the ".hfv"
  36.     files after Executor crashes).
  37.  
  38.  
  39.  
  40. MORE INFORMATION AVAILABLE AFTER YOU INSTALL
  41.  
  42. The installation process creates a "docs" directory that contains
  43. other files that may help you to better understand Executor.  The most
  44. important of these is called "faq", which stands for "answers to
  45. Frequently Asked Questions".
  46.  
  47.  
  48.  
  49. EXECUTOR NEEDS A MOUSE DRIVER TO WORK
  50.  
  51. In addition to needing a mouse to be physically connected to your
  52. computer, Executor requires a mouse driver to be loaded before it can
  53. run.  If Executor complains that you don't have a mouse installed,
  54. even though you have one connected, the problem is that your
  55. autoexec.bat does not load the mouse driver for use with DOS programs.
  56. Since many people only use their mouse with Windows, which has its own
  57. mouse driver, they don't have the mouse driver commands in their
  58. autoexec.bat.
  59.  
  60. The exact changes that need to be made to your autoexec.bat varies
  61. depending on what type of mouse you have, and where the mouse driver
  62. has been installed on your system.  In general, anyone knowledgeable
  63. about your particular configuration should be able to give you simple
  64. instructions for modifying your autoexec.bat, whether that's the
  65. technical support line of the company that made the machine, or your
  66. local DOS wizard.
  67.  
  68.  
  69.  
  70. HOW TO GET STARTED COPYING MACINTOSH FORMATTED FLOPPIES
  71.  
  72. Executor/DOS can only read High Density (1.4 MB) formatted floppies.
  73. Most older Macintosh applications were distributed on 800K floppies
  74. which can't be used with Executor, so MAKE SURE you use 1.4 MB
  75. Macintosh formatted floppies with Executor/DOS.  Executor/DOS doesn't
  76. format floppies for you; you'll have to do that on a Macintosh, for
  77. now.
  78.  
  79. The key to copying Macintosh formatted floppies is the "Desk
  80. Accessory" called HFS_XFer.  Desk accessories are little programs that
  81. piggyback off other programs to do their work.  It's like the old
  82. Vermont joke (beware, provincial humor does not always translate well)
  83. "You can't get there from here (pause) you have to go someplace else,
  84. first".  The upshot is that you must run a program, almost any
  85. program, in order to find and use "HFS_XFer".  I usually start up the
  86. "Mines" program.  Once Mines is started, and the initial "OK" box is
  87. clicked, you can find "HFS_XFer" under the Apple menu at the far left
  88. of the menu bar.
  89.  
  90. Internally at ARDI we have a file browser that allows you to
  91. graphically copy, delete and rename files.  It will be included with
  92. E/D 2.0, but it is not yet available to the general public.
  93.  
  94. It is important to note that you have three different areas that you
  95. can copy to/from.  In addition to Macintosh formatted floppies, you
  96. can copy Macintosh files to your hard disk, either as DOS files, or as
  97. Macintosh files within a single DOS file which represents a Macintosh
  98. "volume".  This fully-enabled version of Executor/DOS 1.99x also
  99. allows you to copy to/from Mac formatted SCSI drives (if you have a
  100. SCSI adapter) and copy from Mac formatted CD ROMs if you have a CD ROM
  101. drive.
  102.  
  103. When you copy Mac files as DOS files, they are broken up in two
  104. halves.  One half will have the original name of the file, the other
  105. will have a "%" prepended to the original name.  The file with the
  106. original name represents the "data fork" of the Macintosh file, and
  107. that's where data that can be used in both Macintosh and DOS
  108. environments resides.  The other half, the one with the "%" prepended
  109. is the "resource fork" and it contains information that only makes
  110. sense in the Macintosh environment.
  111.  
  112. Using the DOS filesystem to represent Macintosh files is very awkward.
  113. In fact, if the names contain funny characters, you might get an "I/O
  114. error".  The alternative is to store files within a single "Macintosh
  115. Volume".  This demo version of Executor comes with a 5 MB Mac Volume.
  116. It should be sufficient to allow you to explore Executor.  While
  117. Executor is working within a Macintosh volume, files can have upper
  118. and lower case names with lengths up to 31 characters, but your DOS
  119. programs can't see the individual files.  More about what's going on
  120. is in the printed documentation.
  121.  
  122.  
  123.  
  124. USING MKVOL TO CREATE A NEW VOLUME
  125.  
  126. Although we don't supply documentation with this demo version of
  127. Executor, you may notice the "MKVOL" program in the "\EXECUTOR"
  128. directory.  If you are adventurous and want to use mkvol, it is
  129. important that the new volume that you create have the suffix ".HFV".
  130. If you do not call your new volume "something.HFV", Executor will
  131. ignore it.
  132.  
  133.  
  134.  
  135. RUNNING PROGRAMS DIRECTLY OFF FLOPPIES
  136.  
  137. Running programs directly off floppies is incredibly slow.  You will
  138. find it much quicker to use HFS_XFer to copy a program from a floppy
  139. into one of your ".hfv" files and then run the program directly out of
  140. the ".hfv" file.
  141.  
  142.  
  143.  
  144. UNIXISMS LEFT IN EXECUTOR
  145.  
  146. Executor was developed originally under UNIX.  A few "UNIXisms" have
  147. remained in Executor; they will be gone in 2.0.  Sometimes you will
  148. see "/" used where "\" would normally be used in DOS.  In addition,
  149. switches are introduced with a leading "-" instead of "/".  We
  150. apologize for this annoyance.
  151.  
  152.  
  153.  
  154. USE WITH WINDOWS
  155.  
  156. Executor/DOS 1.99x will run under Windows 3.1.
  157.  
  158. You can make a double-clickable icon for Executor by using the
  159. Program Manager in Windows:
  160.  
  161.         Choose "New..." from the Program Manager "File" menu
  162.  
  163.         Click the "Program Item" radio button
  164.  
  165.         Click "OK"
  166.  
  167.         Enter "Executor" in the Description field
  168.  
  169.         Enter "c:\executor\executor" in the Command Line field
  170.  
  171.         Enter "c:\executor" in the Working Directory field
  172.  
  173.         Add a Shortcut Key if you wish
  174.  
  175.         Click on "Change Icon...
  176.  
  177.         Click on "OK" when the error message comes up
  178.  
  179.         Find, Select and Click OK on an Icon you like
  180.  
  181.         Click on "OK" to leave "Program Item Properties"
  182.  
  183. Remember, Executor is its own windowing system.  It does not need
  184. Windows to be effective, although the only way you can run two Mac
  185. programs at once it to do so under Windows.  Once you have one copy of
  186. Executor running under Windows, you can use "Left_Alternate-Tab" and
  187. "Right_Alternate-Enter" to hot-key back and forth between different
  188. programs and screen modes.
  189.  
  190.  
  191.  
  192. USE WITH OS/2
  193.  
  194. Executor/DOS 1.99x works with OS/2 2.11, but not with previous versions.
  195. To get E/D 1.99x to run you'll need to adjust use these settings:
  196.  
  197.     DPMI_DOS_API ENABLED
  198.     DPMI_MEMORY_LIMIT 16
  199.     EMS_MEMORY_LIMIT 0
  200.     XMS_MEMORY_LIMIT 0
  201.  
  202.  
  203.  
  204. USE WITH NT
  205.  
  206. Currently, Executor/DOS 1.99x does not run under Windows NT.  This should
  207. change soon, I believe.
  208.  
  209.  
  210.  
  211. IF EXECUTOR RUNS SLOWLY
  212.  
  213. Executor needs about 4 MB of memory to work efficiently.  If it does
  214. not have enough physical memory, it will make do by writing
  215. infrequently used parts of itself to your hard disk and only "paging"
  216. them in when they're actually used.  However, DOS systems can have
  217. their memory artificially eaten up in too many ways to describe here.
  218. If think Executor is running slowly, you might want to have a DOS guru
  219. check to make sure that it's not being memory starved.
  220.  
  221.  
  222.  
  223. CREDITS
  224.  
  225. Executor is a product of ARDI (Abacus Research and Development, Inc.).
  226. The majority of Executor proper was designed and implemented by
  227. Clifford T. Matthews.  The synthetic CPU and DOS port were done by
  228. Mathew Hostetter.  Executor was originally written under X-Windows,
  229. then ported to NEXTSTEP and finally ported to DOS using DJGPP, a port
  230. of the Free Software Foundation's gcc compiler done by DJ Delorie.
  231. The file "EXECUTOR.EXE" is actually a modified version of DJ's "GO32"
  232. DOS extender, the source to which is freely available, from us (for
  233. the cost of a floppy plus postage).
  234.  
  235. More information about the Free Software Foundation and DJGPP is
  236. included in our documentation.
  237.  
  238.  
  239.  
  240. Thanks!
  241.  
  242. Clifford T. Matthews    questions@ardi.com
  243. Founder                 +1 505 766 9115 Phone
  244. ARDI                    +1 505 247 1899 FAX
  245.